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About This Manual 


This manual is the latest release of instructions relating to the PlayStation® Performance Analyzer as of 
Run-Time Library release 4.3. The purpose of this manual is to provide general instructions on using the 


Performance Analyzer software. 


Changes Since Last Release 


There have been no substantive changes to this manual since the previous release, which described 


software version 2.04. 


Related Documentation 


This manual should be read in conjunction with the Performance Analyzer Technical Reference. 


Manual Structure 


Section 


Ch. 1: Overview 
Ch. 2: Tutorial 


Ch. 3: Using the Trigger Function 


Ch. 4: Details 


Description 


Describes, using a sample program, the basics 
of operating the Performance Analyzer (hereafter 
abbreviated to PA), including measurement using 
the basic setup and reading the measured 
results. 


Describes setting the conditions supported by 
the trigger function. The use of the trigger 
function enables the measurement of the target 
frame. 


Describes the menus, buttons and graphs 
displayed in the main window. 





Developer Reference Series 


This manual is part of the Developer Reference Series, a series of technical reference volumes covering all 
aspects of PlayStation develooment. The complete series is listed below: 


Manual 
PlayStation Hardware 


PlayStation Operating System 


Run-Time Library Overview 


Run-Time Library Reference 
Inline Programming Reference 


SDevTC Development Environment 


Description 


Describes the PlayStation hardware architecture 
and overviews its subsystems. 

Describes the PlayStation operating system and 
related programming fundamentals. 

Describes the structure and purpose of the 
run-time libraries provided for PlayStation 
software development. 

Defines all available PlayStation run-time library 
functions, macros and structures. 

Describes in-line programming using DMPSx, 
GTE inline macro and GTE register information. 
Describes the SDevTC (formerly "Psy-Q") 
Development Environment for PlayStation 
software development. 
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3D Graphics Tools 


Sprite Editor 


Sound Artist Tool 


File Formats 
Data Conversion Utilities 


CD Emulator 


CD-ROM Generator 
Performance Analyzer User Guide 


Performance Analyzer Technical Reference 


DTL-H2000 Installation and Operation 


DTL-H2500/2700 Installation and Operation 


Describes how to use the PlayStation 3D 
Graphics Tools, including the animation and 
material editors. 


Describes the Sprite Editor tool for creating 
sprite data and background picture 
components. 


Provides installation and operation instructions 
for the DIL-H800 Sound Artist Board and 
explains how to use the Sound Artist Tool 
software. 


Describes all native PlayStation data formats. 


Describes all available PlayStation data 
conversion utilities, including both stand-alone 
and plug-in programs. 

Provides installation and operation instructions 
for the CD Emulator subsystem and related 
software. 


Describes how to use the CD-ROM Generator 
software to write CD-R discs. 

Provides general instructions for using the 
Performance Analyzer software. 

Describes how to measure software 
performance and interpret the results using the 
Performance Analyzer. 

Provides installation and operation instructions 
for the DTL-H2000 Development System. 
Provides installation and operation instructions 
for the DTL-H2500/H2700 Development 
Systems. 





Typographic Conventions 


Certain Typographic Conventions are used through out this manual to clarify the meaning of the text. The 
following conventions apply to all narrative text except for structure and function descriptions: 


Convention Meaning 
courier Indicates literal program code. 
Bold Indicates a document, chapter or section title. 


The following conventions apply within structure and function descriptions only: 


Convention Meaning 


Medium Bold Denotes structure or function types and names. 


Italic Denotes function arguments and structure members. 
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Developer Support 
Sony Computer Entertainment America (GCEA) 


SCEA developer support is available to licensees in North America only. You may obtain developer support 
or additional copies of this documentation by contacting the following addresses: 


Order Information Developer Support 

In North America In North America 

Attn: Developer Tools Coordinator E-mail: DevlTech_Support@playstation.sony.com 
Sony Computer Entertainment America Web: htto://www.scea.sony.com/dev 

919 East Hillsdale Blvd., 2nd floor Developer Support Hotline: (650) 655-8181 
Foster City, CA 94404 (Call Monday through Friday, 8 a.m. to 5 p.m., 
Tel: (650) 655-8000 PST/PDT) 





Sony Computer Entertainment Europe (SCEE) 


SCEE developer support is available to licensees in Europe only. You may obtain developer support or 
additional copies of this documentation by contacting the following addresses: 


Order Information Developer Support 

In Europe In Europe 

Attn: Production Coordinator E-mail: dev_support@playstation.co.uk 

Sony Computer Entertainment Europe Web: httos://www-s.playstation.co.uk 
Waverley House Developer Support Hotline: 

7-12 Noel Street +44 (0) 171 447 1680 

London W1V 4HH (Call Monday through Friday, 9 a.m. to 6 p.m., 
Tel: +44 (0) 171 447 1600 GMT or BST/BDT) 
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Required Equipment, Recommended Hardware 


The following equipment is necessary to use the Performance Analyzer: 


PlayStation Board (DTL-H2700), 

PS-X Software Develooment Tool, 

IBM PC/AT or compatible (with one free ISA bus slot (however, space equal to three slots is required), 
Windows 95 or Windows NT4.0, at least 832 MB of RAM, 200 MB of free disk space, and a monitor 
supporting a resolution of 1024 x 768, 16-bit color.) 

Performance Analyzer (DTL-S2710). 


Features 


The Performance Analyzer provides the following features: 


It incorporates 64 MB of DRAM so that 128-bit data corresponding to about 7.4V blanks (NTSC) or 
about 6.2V blanks (PAL) can be read per clock and analyzed. 

It can observe most of the external signals of the CPU chips and the video RAM bus of the GPU. Asa 
result, the situations of interrupts, sub bus access and video RAM access can be identified, in addition 
to the main RAM access status. 

It can easily analyze CPU data duplicate read, write buffer flush, GPU packets, etc. 

It analyzes the main RAM access situation by distinguishing between the normal and DMA transfer of 
the CPU, GPU, etc. and indicates the bus usage information using colors. This makes it possible for 
the user to quickly comprehend the bus access situation in a frame section. 

It is capable of displaying waveforms either as a graph or as a listing of figures, in the same way as a 
logic analyzer. 

It can read map files output from compilers and display the access situation for segments and global 
symbols. 

It supports the calculation of statistics for a specified range. 

It supports simple mouse-based operation in the GUI environment. Also, thanks to its use of a multi- 
document configuration and a split-window method, it enables the efficient comparison of large 
amounts of data, the comparison of data with previously obtained and saved data, and the easy 
comparison of tuning results. 

An ISA bus add-on board, used as the Performance Analyzer interface, allows measured data to be 
downloaded quickly. 

The start of measurement can be triggered according to the main RAM bus address and data condition 
as well as by using the trigger switch. 

It can read and analyze data of up to 6V blanks prior to the trigger position. 


Using the Performance Analyzer with the software development tools 


The Performance Analyzer can be used with the PlayStation software develooment tools concurrently, i.e., users can 
use a tool such as a debugger while running the Performance Analyzer. Both environments work independently. 
Therefore when the PlayStation CPU is reset, the contents of the trace memory in the Performance Analyzer 
remains the same. 
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Measurement Using the Basic Setup 
The description given in this section covers the installation of PA, how to execute the program to be measured and 
how to perform measurement using the basic setup. 


Installing PA and setting up a temporary directory 
Read the “\pa\setup_j.txt” file to install driver and execution files. This file is contained in the CD-ROM. 


As PA uses a large amount of disk space for Its temporary files (up to around 100 MB per data item), the temporary 
directory must be created on a drive which has a large amount of free space. 


Execute PA only after the above settings have been completed. 


Figure 2-1 : State of PA before measurement 
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Executing the program to be measured 


The program to be measured with the Performance Analyzer should be executed independently of PA. The 
program can be executed either from a CD or by downloading. This is outside the scope of this manual, however. 
Note that the program development environment should be set up before executing the program. For details of 
setting up and using the program development environment, refer to DTL-H2500/H2700 Installation and Operation 
and SDevTC Develooment Environment. 


The following is sample usage with SDevTC combined under the Windows95 environment. 
Execute the following command(s) from the DOS prompt. 


[When executing a program on a CD] 
C:\> resetps O 


[When downloading a program] (When executing the sample program provided with PA) 
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C:\> CD \PA20\SAMPLE 
C:\PA20\SAMPLE> resetps 1 
C:\PA20\SAMPLE=> run tutoO 


Figure 2-2: Download Screen 





Prompt 


Criedexbios /ai34o0 

DEXZBRIOS version 1.25 

Installed OF - card addr » 1540, Interrupt —- 
Ciyeed Pizzo’ SAMPLE 


CiyPaeO*}SaNPLEsresetps 1 


sony Playstation DTL-H2000 RESET utility 1.02 
Copyright [c) 1994 3 WNW Systems Ltd. 


Done. 
Cr\Paz0),SaMPLEtrun tutod 
RUN.EXZE Executable/Binary file downloader version 2 
Copyright f[c) 1992 to 1995 3 WN Systems Ltd. 
Target 0 13 RS000 — SONY Pax4.o00 
Loading file TUTOO.CPE 


starting target C 
OK 


Cr\Pi20' SAMPLE? 


The description in the subsequent sections assumes the use of the downloaded sample program. 


Setting the IO port address 


The lO port address should be set before using the performance analyzer (PA) to analyze the sample program. 
From version 2.04, the IO Port Address must be set when the driver is installed. For further details, see 
\pa\setup_j.txt. 


Executing measurement using the basic setup 


With the default setup, measurement start timing is specified using only a trigger switch (the provided foot switch). 
Other conditions that can be used for triggering measurement include the main RAM address and data, which can 
be selected with "Trigger Condition..." on “Setting” menu. For details, see Section 3.1, "Setting the Trigger 
Conditions." 


From “Run” menu, select "Acquisition..." The following dialog box will appear: 
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Figure 2-3: Measurement Dialog Box 
Acquisition 


Acquisition 


Status: YW aitting for Trigger Switch 





Press the trigger switch when the scene to be measured appears. Data read starts immediately, provided there is 
no trigger condition other than the trigger switch, as in this example. If trigger conditions other than the trigger 
switch are specified, the data to be measured once all the conditions are satisfied starts to be read when the switch 


is pressed. 


Figure 2-4: Dialog Box During Data Read 
Downloading Data 


Downloading Data -.. 664 





Basic Operations 


This section describes the basic analysis operations such as main window display setting and cursor manipulation. 
For details of the graphical display of the analysis, waveform and access, see the "Main Window Description." 


section of this manual. 
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Figure 2-5: State of PA After Measurement 
| — /O x! 
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Switching the displayed graphs 


The graphs that can be displayed are seven analysis displays, a waveform display and two access displays. 
Ainougn 2 all of the graphs a are | by default, all can be switched on-off independently using the nine buttons 





7 Biel sss] ca) ‘at the right-hand end of the tool bar. The graph corresponding to each button 
is aipieved while the button i iS depressed, and not displayed while the button is released. 


Upon the completion of measurement, a slight delay is incurred before a graph is displayed. This delay increases as 
the view size decreases and the view area increases, but can be minimized by “switching off" any graphs which 
need not be displayed. For example, it is possible to set the buttons so that only the main RAM bus and video RAM 
bus analysis graphs are displayed. The other graphs are displayed only when required. 


Display switching can also be set using the Option dialog box. By saving the setting, it can be set as the default to 
be used subsequently. For details, see the "Option Dialog Box." section of this manual. 


Using the cursors and markers 


Clicking the mouse in the main window causes a vertical line to appear. This is the cursor used to indicate the 
position currently being examined (the cursor is located at the clock O point when the view is created for the first 
time). Then, click the right-hand graph. You will see that a cursor can be set In it, independently of that in the left 





graph. Now, open “View” menu and execute "Reset M1 to cursor point." (kz) A marker named M1 is displayed 
on the scale. Clicking a point close to the marker moves the marker to the clicked point. PA has two markers, 
named M1 and M2. These markers are used for marking positions and setting a range for which statistical 





measurement is to be performed. Now, click the mouse, move the cursor to another position and click a on the 
tool bar; M2 moves to the cursor position. As shown here, the markers can also be moved with the tool bar 
buttons. It is important to note that, while the window is split, the cursors of the left-hand and right-hand graphs 
function independently, but M1 and M2 are common to both windows. 
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CT 
After measurement, another marker MT, which is used to indicate the trigger point, is displayed. Clicking on the 
tool bar moves the cursor to the trigger point. 


Figure 2-6: Cursor, Markers and Trigger Position 
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Enlarging or reducing the view 


To display a wider area by reducing the view, select "Reduce Scale" from ’View” menu. This opens another menu 
which allows you to select any of a variety of view sizes. For example, selecting "Zoom Out" reduces the view to half 
its current size. To enlarge the view, select "Increase Scale" from “View” menu. Then, specify the size in the same 
way as above. Selecting "Zoom In" enlarges the view to twice its current size. To return to the actual size (where 
each pixel corresponds to a clock pulse), select "Normal size" from “View” menu. These view size change 
commands are applicable to all views, even when the window Is split. The size is displayed at the top left of the 
view, and the display is scrolled so that the cursor is centered. 


In much the same way as the Move commands, the view size change commands are also registered on the tool 


bar. Is for Zoom in, Is for Zoom out, and is for the normal size. av 2%] and allow the user to 


change the view size so that the display of the respective frame sections fills the screen (note, however, that the 
sections may not be displayed correctly when a compact display device is used). 


Changing the analysis display and pixel width 

The analysis display is a vertical bar when the view size is set to 1, but reducing the view size turns the one pixel- 
wide bar into a histogram. For example, when the view size is set to 1/16, the histogram shows the percentage of 
each status over 16 clocks as a color display (the order in the vertical direction Is fixed in the same way as the label 
on the left). Now, set the view size to 1/512; the histogram is averaged so that the change in the bus usage with 
respect to time Is displayed visually. Next, restore the size to 1/64. The analysis display will be as shown below. 
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Figure 2-7: Analysis (Size 1/64, Pixel Width 1)) 
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This display is so fine that colors mix with adjacent colors making identification difficult. Therefore, select 
"Options..." from “Setting” menu and change "Analysis Pixel Width" in the Option dialog box. 
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This option is provided to make the histogram easier to understand by changing the pixel width. The default pixel 


width Is one pixel. If, however, it is changed to five pixels, the analysis display will change as shown below. 
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Figure 2-9: Analysis (Size 1/64, Pixel Width 5)) 
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As described above, the pixel width can be changed as desired to make the display easier to understand. 


Changing the display levels of the waveform display and access display 


The level at which the waveform display is hidden can be set as follows: First, set the view size to 1/16 and click 
OK. The waveform is displayed. Then, change the view size to 1/8 then back to 1/16. You will notice that the 
waveform is displayed at 1/8 but not at 1/16. The level at which the waveform display is displayed or hidden can be 
set by selecting "Options..." from “Setting” menu then changing the level of "Display level of Waveform" in the Option 
dialog box. The default hidden level is 16, but if you change this level to 32, the waveform Is displayed. The level at 
which the access display is displayed or hidden can also be set by selecting "Options..." from “Setting” menu then 
changing the level of "Display level of Access" in the Option dialog box. 
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Reading the map file 


To read a map file, select "Read file" from “Map Info” menu. 
The system currently supports the reading of the following three kinds of map files. 
Remember, however, that segment information cannot be obtained with map files other than 1). 


1) Map files created in the SDevTC develooment environment (*.map). 


Example: ccosx -O83 -X0$80010000 /m tuto0.obj-otuto0.cpe,tuto0.sym,tuto0.map 


2) Symbol files (*.dsm) created using dumpsym from symbol files created in the SDevTC development 
environment (*.sym). 


Example:ccpsx -O3 -X0$80010000 tuto0.obj-otuto0.cpe,tuto0.sym 
dumpsym tutoO.sym > tutoO.dsm 


3) Symbol files created using nm in a development environment such as NEWS (*.nm). 


Example: nm a.out >a.nm 
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Figure 2-11: Read Map File Dialog Box 
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Setting the Stack Range 


In the PlayStation, the stack area is set by the kernel, by the linker or by the user program. The default range of the 
stack area is from Ox801CO000 to Ox80FFFFFF. These values should be changed to specify the correct stack area 
for each program to show the access display correctly. 


From “Setting” menu, select "Options..." then change "Stack Range of a tested program" in the Option dialog box. 
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Figure 2-12: Option Dialog Box - Stack Range of a Tested Program 
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Identifying the Functions Causing Cache Misses (Use Filter) 


First, specify the range of the main RAM bus where instruction burst read (cache misses) is noticeable (see Section 
2.2.2, ‘Using the cursors and markers’). 


Next, check “Use filter" in “Map Info” menu. This displays the global symbols accessed within a specified range. 
Among the global symbol accesses, those for which the main RAM bus is in the instruction bus read state are the 
functions for which cache misses occur. 


Every time the above range specification is changed, it is necessary to repeat filtering by selecting "Filtering" from 
“Map Info” menu. 
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Figure 2-13: Use Filter 
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Move and Search Move 


When the pull-down “View” menu is displayed, you will see items including "Go to cursor" (Lf), "Go to M1" ( 


[Mi], "Go to M2" [M2], “Move cursor to Trigger point” ( ), "Move V Blank point" and "Move in Clocks." 
These menu items are used to move the view on the screen. Some are registered as tool bar button commands so 
that they can be executed directly. When the window Is split, these move commands are applied to the current 
view, that is, they scroll that graph on which the mouse was last clicked. When "Move in Clocks" is selected, the 
dialog box described below appears. 


Specify the move destination as a clock position, then click OK to move to that point (the initial value is the current 
cursor position). Note that "Move V Blank point" and "Move in Clocks" scroll the view by moving the cursor position. 
The view is scrolled so that the move destination is placed at the center of the screen. 


"Reset M1 to Origin" and "Reset M2 to Origin" in “View” menu move M1 and M2, respectively, to the origin 
coordinate. These items do not perform scrolling. "Redraw" on “View” menu is used to refresh the view. 


Figure 2-14: Move to Clock Point Dialog Box 
Go to Clock Position 
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Cancel 
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"Move to Search point" enables movement to the point where the desired conditions are satisfied, among the seven 
analysis displays, waveform display and access displays. Selecting "Move to Search point" on “View” menu allows 
you to specify the following search conditions: 


Main RAM bus condition (instruction burst read, etc.). 
Access to an arbitrarily specified address on the main RAM bus. 
Arbitrarily specified data on the main RAM bus. 
Sub bus condition. 
Video RAM bus condition. 
Range of Video RAM access (location where an access in the specified range occurred) 
Note: Check “Range of Video RAM access” radio button to enable the condition. 
GPU packet type. 
Signal waveform (Search according to changes such as positive-going and negative-going). 
) Read/Write penalty stall cycle position. 
) Write buffer penalty stall cycle position. 
) Polygon penalty position. 


OONOAFRWN — 
a a Oe ee 


— —- —1 


Figure 2-15: Search Dialog Box 
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Click "Previous Search" button or "Next Search" button to start search. To cancel search, click "Stop" button. Use 
"AND" and "OR" buttons to combine the search conditions. 
Descriptions of the buttons are as follows: 


“Method of Search” - AND/OR “AND”: Search the position satisfying all conditions. 
“OR”: Search the position satisfying at least one condition. 


“Previous Search” button search the previous position satisfying the desired conditions. 
“Next Search” button Search the next position satisfying the desired conditions. 
“Stop” button Stop searching. 

“Clear” button Clear search conditions. 

“Close” button Close the search dialog box. 


Using the Window (Data Comparison) 


The split bar separates views. Dragging the split bar allows to change the dimensions of the view areas. To 
temporarily hide split window display, move the split bar to the top/bottom or left/right edge of the screen. The split 
bar can also be erased completely to return a split window to the original, non-split window by double-clicking the 
split bar. If the window Is split by both vertical and horizontal split bars, the original window can be re-displayed 
simply by double-clicking the intersection of the vertical and horizontal split bars. Next, if you double-click the small 
bar at the end of the scroll arrow of the original window, the view is split into two views. While dragging the split bar 
enables the splitting of the view into arbitrarily sized areas, this operation splits the view into two views of equal 
areas. 


The Performance Analyzer supports a multi-document configuration, that is, it is capable of displaying several data 
items simultaneously to enable their comparison. You can either open and display a previously saved file, or you can 
select "Open new window" from “Window” menu to display a copy of the data already being displayed. You can 
also select "New" from “File” menu, measure signals, and select "Tile" in “Window” menu. This will result in the 
display of the screen shown below. 
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[Symbol Access] 
stack_seg 
text 
.sdata 
hss 


Ready 


By combining these functions and the split window function, programs can be tuned while comparing data. 


Operation of Analysis Tools 


PA incorporates three analysis tools: Dump data, Statistical amount and Video RAM viewer. 


Dump Data 
This tool displays the data around the cursor by data dumping. 
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Select "Dump data..." from “Tool” menu, press the Dump data button on the tool bar or double-click the 


desired position in the main window. 
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Figure 2-17: Dump Data 
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The dumped data contents are as follows: 


POS: Indicates the clock position. 

MB STAT, R/W: Indicates the main RAM bus status. 

<Blank>: Idle. 

IR: Instruction burst read. 

DR: CPU data read access. 

DW: CPU data write access. 

GR: GPU DMA data read access. 

GW: GPU DMA data write access. 

CR: CD read access. 

CW: CD write access. 

SR: SPU DMA read access. 

SW: SPU DMA write access. 

MR: Internal DMA read access. (Includes MDEC and OT clear). 

MW: Internal DMA write access. (Includes MDEC and OT clear). 

PR: PIO DMA read access. 

PW: PIO DMA write access. 

al RAS pre-charge period. (An extra cycle required to access the main memory.) 
R: Refresh cycle. 

U: Undefined. 

NWORD: Total number of words transferred in RAS cycle. 

NBYTE: Total number of bytes transferred in RAS cycle. (Only write is significant.) 
MADDR: Main RAM bus address. (Ox80000000 is assumed as the start address.) 
SYMBOL: MADDR global symbol display. 

OFFSET: Offset in SYMBOL. (hex notation. Not displayed in stack.) 

MWENO-S: Bytes which are written in a word. ("w": written, "-": not written.) 

SB STAT, R/W: Sub bus status. 
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<Blank>: Idle. 
AP: Read access to PIO. 

WP: Write access to PIO. 

RC: Read access to CD. 

WC: Write access to CD. 

RS: Read access to SPU. 

WS: Write access to SPU. 

RR: Read access to ROM. 

RO: Read access to other devices. 

WO: Write access to other devices. 

U: Undefined. 

SA: Sub bus address. 

VM MODE: Video RAM bus mode. 
R/W: Pixel read/write access. 
RMW: Pixel read modify write (semi-transparent) access. 
TXR: Texture read access 
CR4: 4-bit (16-color) palette read access. 
CR8: 8-bit (256-color) palette read access. 
OPC: Control video RAM cycle. 
VM ACCO: Access of video RAM chip 0. 
VM XO: X coordinate of video RAM chip O. 
VM YO: Y coordinate of video RAM chip O. 
VM ACC1: Access of video RAM chip 1. 
VM X1: X coordinate of video RAM chip 1. 
VM Y1: Y coordinate of video RAM chip 1. 
GUNINT*: Interrupt request from Gun. 
RXD1*: Link cable signal (received data). 
DSR1*: Link cable signal (Data Set Ready). 


CTS1*: Link cable signal (Clear To Send). 
Note: "*" indicates a negative logic signal. 
Note: If the stack range is not set properly, the global symbol having the highest address may sometimes be 


mistakenly identified and displayed as the stack address. 


Statistical Amount 


Statistics enable the investigation of the share of main RAM bus, the memory access penalty frequency and the 
number of each polygon type drawn within the specified range. 


First, specify the statistic investigation range as a range between cursors M1 and M2. Then, select "Statistics..." 


from “Tool” menu or press the Statistics button on the tool bar. The range confirmation dialog box is displayed. 
Click OK if the range specified with the markers is satisfactory. 


Figure 2-18: Range Confirmation Dialog Box 
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Figure 2-19: Statistical Amount 
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Speed (Mb fsec) Clock Cyeles sword Estimated CPU Stall Cycles 


131.36 1.0 


60.03 
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Indicates the percentage of the required time. 


Indicates the total number of bytes that have been transferred. However, ina 
read cycle which consists only of word accesses, they are regarded as 4- 
byte accesses. 


Indicates the average transfer speed in each cycle. The maximum value 
is136 MB/sec. 


Indicates the average number of clocks required to transfer a word in each 
cycle. 


These are the stall cycles estimated for the Data Read and Instruction Burst 
Read status. 


Lists the total number of packets of each polygon type. 
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Video RAM Viewer 


The video RAM viewer enables the confirmation of the video RAM positions actually accessed by the CPU within the 
specified range, in terms of frame buffer images. 


First, specify the range to be investigated as a section between cursors M1 and M2. Then, select "Video RAM 
viewer..." from “Tool” menu or press the Video RAM viewer button VI) on the tool bar. 


Figure 2-20: Video RAM Viewer 
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The accessed pixels are displayed in palette colors according to the access frequency (Low: Blue, High: Red). It is 
also possible to display read and write accesses separately by selecting the Read/Write checkbox accordingly. This 
makes it possible to read the sections where polygons are drawn, the texture and CLUT as well as to identify the 
sections to be subject to semi-transparent processing. 
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Setting the Trigger Conditions 


The trigger conditions should be set to specify the timing at which the actual measurement will be started. The 
default trigger condition is set only to the trigger switch (foot switch). 


The trigger conditions include the trigger switch, main RAM address bus, main RAM data bus, device signal (from 
the Gun or link cable). Any number of conditions can be specified. When more than one trigger condition is 
specified, the reading of measurement data starts from the position where all of the specified conditions are 
satisfied. It is also possible to use the measurement data of up to 6V prior to the trigger position where the trigger 
conditions are satisfied. 


Clicking the OK button after changing the parameters applies them to the current file. Clicking the “Save” button 
applies the changed parameters to new files that are next created. 


Figure 3-1: Set Trigger Condition Dialog Box 
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First, select the trigger conditions to be used from the six conditions listed below (more than one can be selected). 


For "Main RAM address bus" and "Main RAM data bus" the related items can be entered only when they are 
selected here. The conditions can be inverted except for “Trigger switch" and "Main RAM address bus". By 
inverting a condition, the condition is satisfied whenever the original condition is not satisfied. 


Performance Analyzer User Guide 


3-4 Using the Trigger Function 


Trigger switch: Adds the trigger switch to the trigger conditions. 

Main RAM address bus: Adds the main RAM address to the trigger conditions. 

Main RAM data bus: Adds the main RAM data value to the trigger conditions. 

Gun (GUNINT): Adds the Gun-related interrupt request signal to the trigger conditions. 
Link cable (RXD1): Adds the link cable signal (received data) to the trigger conditions. 
Link cable (DSR1): Adds the link cable signal (Data Set Ready) to the trigger conditions. 


Note: When more than one condition is set, the main RAM address bus and data bus are compared at the 
same timing but GUNINT, RXD1 and DSR1 are compared upon the occurrence of timing errors of a few 
cycles. When the trigger switch is added to the trigger conditions, other conditions are checked after 
the trigger switch is pressed. Therefore, it is not necessary to keep the trigger switch held down. 


Main RAM Address Bus 


The address value obtained from the main RAM address bus can be specified as a trigger condition. This address 
covers all main RAM accesses including instruction burst read, data read and data write. The inout should be a hex 
number and the setting range be between 80000000 and 807FFFFF. The lower two bits are invalid if a size is not 
specified (the size specification is explained below). The mask input should also use a hex number. When the mask 
bit is 1, the bit of the corresponding address becomes a valid condition. When the mask bit is O, it is not included in 
the condition. 


Example: To specify 80010000 to 8001FFFF 
Address: 80010000 
Mask: FFFFOOOO 


The address value can also be read from the symbol list, provided the map file has been read. 


Figure 3-2: Reading from the Symbol List 
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Note: Care is required when you use the address of a function as a trigger condition, as the Performance 
Analyzer cannot observe the functions in the instruction cache. This is because it can measure the 
status appearing on the bus, but cannot measure the status within the CPU. Therefore, while it is 
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possible to use a function which always causes a cache miss as a trigger condition, It is safer to use a 
data address as the condition. 


Main RAM Data Bus 


The data value obtained from the main RAM data bus can be specified as a trigger condition. This data covers all of 
the main RAM accesses including instruction burst read, data read and data write. The read/write distinction and 
size can also be specified but, when a size is specified, a mask appropriate for the size should be used. 


Example: To specify half-word access with a value of 1234 (hex number) 
Data value: 00001234 
Mask: OOQOOFFFF 


Read/write and size specifications 

When the "Main RAM address bus" or "Main RAM data bus", described above, is specified as a trigger condition, 
the read/write distinction and size of the access can be added to the conditions. This can be set either 
automatically or manually. Note that the size specification is valid only for write accesses. 


Specification by data type 


Read/write specification, which can be set from Read or Write, Read, and Write. 

Size specification, which can be selected from Byte, Half Word and Long Word. (The size specification 
can be made only with Write.) 

(When Byte or Half Word is specified, the word boundary is dependent on the lower two bits of the 
address. To set Byte or Half Word, which is different from the word boundary of Long Word, as the 
data condition without specifying the address condition, use manual setup.) 


Specification by hardware signal 


Read/write can be specified using four bytes in a word. 
The checkbox to the right of "8210(byte)" indicates write when checked and read when not checked. 
As masks are provided below it, check those for which you wish to validate the setup. Those positions 
for which the masks are not checked are not included in the condition. 


NFV (Number of V blanks Before the Conditions are Satisfied) Setting 


This enables the specification of the number of V blanks, before the conditions are satisfied, that are to be included 
in the data measurement. A value of between 1 and 6 can be set. The default is 1, where the data in the V blank 
containing the triggering position is measured. 


Setting the Measurement Range 
The measurements performed up to this point have been done within the default range (over 2V blanks). 


To change the measurement range, select "Options..." from “Setting” menu then setting “Data Acquisition Range” in 
the Option dialog box. 
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Figure 3-3: Setting the Measurement Range (Option Dialog Box) 
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Clicking one of the radio buttons the corresponding clock range. The All memory radio button corresponds to the 
measurement of about 7.4V blanks (NTSC) or about 6.2V blanks (PAL). Increasing the measurement range enables 
the analysis of a larger amount of data, but the time taken for data read and hard disk consumption increase 
accordingly. 
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Techniques 


Measurement can be started from the head of a frame or can be started automatically from the position where a 
frame error occurs, simply by changing the trigger conditions or modifying the program to be measured. 


For details, refer to the Performance Analyzer Technical Reference. 
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Menus and Buttons 


Description of menus 
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The pull-down menus, displayed by selecting menu items, are as follows: 


File: The items in this menu are mainly used for file-related operations. 
New: Create a new file for measuring and saving data. 
Open: Open a previously saved file. 
Close: Close the current window. 
Save: save the current file, overwriting an existing file. 
Save as: Save the current file after assigning another name. 
Print: Print the main graphs. 
Preview: Display a preview of the main graphs as they will be printed. 


Printer setup: 
Previously opened file: 
Exit: 


Set up the printer. 
Open one of the files in the list. 
Terminate the Performance Analyzer. 


View: The items in this menu are used to enlarge or reduce the view size and to manipulate the cursors. 


Reduce Scale: 


Zoom Out 
x1/2 
x1/4 


x1/4096 
Normal Size: 
Increase Scale: 


Zoom In 

x2 

x4 

x8 

x16 

Redraw: 

Go to cursor: 

Go to M1: 

Go to M2: 

Move cursor to Trigger point: 
Move V Blank point: 
1V blank: 

2V blank: 

3V blank: 

AV blank: 

5V blank: 

6V blank: 

7V blank: 

Move to Clock point: 
Move to Search point: 


Reset M1 to cursor point: 
Reset M2 to cursor point: 


A pull-down menu for reducing the view to one of the following 
SIZeS. 


Display each clock as one pixel. 
A pull-down menu for enlarging the view to one of the following 
sizes. 


Refresh the screen by drawing the view again. 

Scroll to the cursor position. 

scroll to marker M1. 

scroll to marker M2. 

Move the cursor to the trigger position. 

Move to the origin. 

Move the cursor to the 1V blank point. 

Move the cursor to the 2V blank point. 

Move the cursor to the 8V blank point. 

Move the cursor to the 4V blank point. 

Move the cursor to the 5V blank point. 

Move the cursor to the 6V blank point. 

Move the cursor to the 7V blank point. 

Move the cursor to a point specified in terms of clocks. 
search for a point according to the set conditions and moves to 
that point. 

Move M1 to the most recently set cursor position. 
Move M2 to the most recently set cursor position. 
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Run: 


Map Info: 


Tools 


setting: 


Window 


Help 


Reset M1 to Origin: 
Reset M2 to Origin: 
Tool bar: 

Status bar: 


Move M1 to the origin. 

Move M2 to the origin. 

Switch the tool bar display on/off. 
Switch the status bar display on/off. 


The items in this menu are used to execute measurement and set up triggering. 


Acquisition...: 


Read data only: 


Displays a dialog box with a trigger button. Pressing the trigger 
causes the sampling of data to begin immediately following the 
end of the next V blank period. The data is then transferred into 
the computer to be displayed. A dialog displays data transfer 
status. Clicking the cancel button will abort the transfer, but any 
previous data will be lost. 

Read previously sampled data. 


The items in this menu are related to the program segments and global symbol information. 


Read file: 


Use Filter: 
Filtering: 


Read the map file output by the linker during compilation to enable 
symbolic address display. 

Display only the global symbols obtained by filtering. 

Obtain the accessed global symbols in the section between M1 
and M2. 


Note: Executing “Filtering” automatically enables "Use filter". 


Dump data...: 


Statistics...: 
Video RAM viewer...: 


Dump the data in the window in text format. (Data can also be 
dumped by double-clicking the cursor position.) 

Calculate and displays bus usage statistics for the specified range. 
Display VRAM accesses within the specified range. 


The items in this menu are used to perform setup. 


Trigger Condition...: 
Options...: 
lO Port Address...: 


New Window: 
Cascade: 

Tile: 

Arrange icon: 


About PA: 


Description of buttons 


Set up the conditions that trigger the start of measurement. 
Set up the environment. 
Set up the IO address. 


Open a new window which uses the same file (data). 
Cascade the displayed windows. 

Tile the displayed windows. 

Arrange the icons. 


Show title, credits, build date, and version. 


In addition to selecting a command from a pull-down menu, frequently used commands can also be executed 
directly by clicking buttons. The button commands are displayed below the menu bar. 
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Open anew file. 

fe Open a previously saved file. 
Save a file. 

Start printing. 


Output the version information. 


Start measurement. 
Read data. 

Set up the triggering. 
Double the view size. 
Half the view size. 

Reset the view size to 1. 





I 
Change the view size so that the entire data for about 1V blank can be displayed. 
Change the view size so that the entire data for about 2V blank can be displayed. 


7 
Change the view size so that the entire data for about 4V blank can be displayed. 


Search for a point according to the set conditions and moves to that point. 





Ea Redraw the view. 


Move to the cursor position. 
4 | 
Scroll to M1. 
2) 
Scroll to M2. 
2) Move the cursor to the trigger position. 
#1 Move M1 to the cursor position. 
' 
J Move M2 to the cursor position. 


il 
[3] Dump data in the window in the text format. 








[| Calculate and displays the statistical amounts. 
[I Display VRAM accesses within the specified range. 


ME 
Switch the main RAM bus analysis display on-off. 
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Switch the sub RAM bus analysis display on-off. 
Switch the video RAM analysis display on-off. 
Switch the GPU packet analysis display on-off. 
Switch the read/write penalty display on-off. 
Switch the write buffer penalty display on-off. 
Switch the polygon penalty display on-off. 


We | 
ea Switch the waveform display on-off. 





=| 
Switch the access display on-off. 


Main Window Description 


This section describes the graph items. 


Names of parts 


A scale is displayed at the top of each view. The figures on the scale indicate the number of clock pulses relative to 
the start of measurement (positive-going of the V blank). (A red line is inserted every 1V blank.) 


The measured data is displayed below the scale. Vertical color stripes in the display indicate the analyses. There 
are seven analyses, those for the main RAM bus, sub bus, video RAM, GPU packet, redundant read, write buffer 
and bad polygon analyses. Small, colored boxes and labels to the left of the analyses indicate the relationship 
between each color and the corresponding status. 


The signal waveforms are displayed below the measured data. The signal names are displayed to the left of the 
waveforms. Below the signal waveforms is the access display for each segment and function, which indicate the 
status of access to each symbol. The functions of these parts are described in the following sections. 
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Figure 4-1: Main Window 
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Write 

Block Write 
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Texture Read 
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Clut Read8 


[ GPU Packets ([#polygons) ] 


None LINE_G2 
Others LINE-F3 
Command LINE-G3 
Null Packet ©) LINE_F 


t 
LINE_F2 Block Fill 


[ Read/Write Penalty (time) ] 
None 
Duplicate Read 


[ Write Buffer Penalty (time) ] 
None 
Flush Penalty 


[ Polygon Penalty {time} ] 


None 

Outside Frame 
Scissoring 
Back Face 
Zero Area 


[Waveform] 
SYSCLK 
VBLNK 
GUNINT* 
RxD 1* 
DSR1* 
cist 


[Symbol Access] 
stack_seg 
data 
etext 
data 
.sdata 
.sbss 
.bss 
unknown location 
_STACK_ 
main 
RotCubeFog 
AddPrimF ogF 
gen_color_sce 
FrnitFlush 
FnitPrint 
memset 
AddPrim 
AddPrims 
TermPrim 
SetSemil rans 
DrawSyne 
ClearOT agh 
DrawPrim 
DrawOT ag 
PutDrawEny 
DrawOT agEnyv 
PutDispEny 
GetDispEny 
SetDrawEny 
memcpy 
printf 
GetRCnt 
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Main RAM Bus Analysis 
The main RAM bus analysis displays the main RAM bus status as a histogram. 


The main RAM bus status Is as listed below. The area of each item corresponds to the duration it occupies the bus. 


Unresolved: 

Idle: 

Refresh: 

RAS Pre-charge: 
PIO DMA Write: 
PIO DMA Read: 
CD Write: 

CD Read: 

SPU DMA Write: 
SPU DMA Read: 


Internal DMA Write: 
Internal DMA Read: 


GPU DMA Write: 
GPU DMA Read: 
Data Write: 
Data Read: 
Inst Burst Read: 


A pattern which cannot be analyzed. 

Idle status (this does not mean that the CPU itself is idle.) 
Main RAM refresh cycle. 

RAS pre-charge period of main RAM. (Hardware’s memory access overhead) 
DMA write cycle of PIO. 

DMA read cycle of PIO. 

Write cycle of CD. 

Read cycle of CD. 

DMA write cycle of SPU. 

DMA read cycle of SPU. 

Internal DMA write cycle (MDEC, OT clear, etc.). 

Internal DMA read cycle (MDEC, OT clear, etc.). 

DMA write cycle of GPU. 

DMA read cycle of GPU. 

Data write cycle of CPU. 

Data read cycle of CPU. 

Instruction burst read cycle of CPU. 


Sub Bus Analysis 
The sub bus analysis displays the sub bus status as a histogram. 


The sub bus status Is as listed below. The area of each item represents the time it occupies the bus. 


Unresolved: A pattern which cannot be analyzed. 
Idle: Idle status. 

Read PIO: Read access to PIO. 

Write PIO: Write access to PIO. 

Read CD: Read access to CD. 

Write CD: Write access to CD. 

Read SPU: Read access to SPU. 

Write SPU: Write access to SPU. 

Read ROM: Read access to ROM. 

Read Others: Read access to other devices. 
Write Others: Write access to other devices. 


Video RAM Analysis 
The VRAM analysis displays the video RAM bus status as a histogram. 


The sub bus status ts as listed below. The area of each item corresponds to the amount of data that has been 
transferred. Therefore, a high pattern value indicates that the data transfer rate is high. 


Note: Since the CLUT transfer is identified based on the number bytes transferred in a read access, when some 
other transactions with the same amount of data occur, wrong analysis may result. 


Idle: Idle status. 
Write: Pixel write cycle. 
Read: Pixel read cycle. 


Read Modify Write: 
Texture Read: 

Clut Read4: 

Clut Reads: 


Pixel read modify write (Semi-transparent) cycle. 
Texture read cycle. 

4-bit (16-color) palette read cycle. 

8-bit (256-color) palette read cycle. 
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GPU Packet Analysis 
The GPU packet analysis displays the GPU packet execution status as a histogram. 


The GPU packet status is as listed below. The area of each item corresponds to the number of packets. Therefore, 
a high pattern value indicates that the packet transfer rate Is high. 


Note: The GPU packet display and the actual drawing on the video RAM bus may deviate in some points. This is 
due to the presence of a packet buffer within the GPU. 


None: A cycle in which the GPU packet is not processed. 
Unknown: A packet which cannot be analyzed. 
Command: Command packet. 

Empty: Empty packet. 

POLY 23: Triangle polygon, flat. 

POLY_FT8: Triangle polygon, flat texture. 

POLY “G3: Triangle polygon, glow. 

POLY Gila: Triangle polygon, glow texture. 

POLY F4: Quadrangle polygon, flat. 

POLY APT: Quadrangle polygon, flat texture. 
POLY_GA4: Quadrangle polygon, glow. 

POLY <Gil4a: Quadrangle polygon, glow texture. 
LINE_F2: Non-concatenated line. 

LINE_G2: Non-concatenated line, with gradation. 
LINE Fe: 3-point concatenated line. 

LINE G3: 3-point concatenated line, with gradation. 
LINE _F4: 4-point concatenated line. 

LINE_GA4: 4-point concatenated line, with gradation. 
SPRT: Sprite (free size). 

SPRT_8: Sprite (8 x 8). 

SPRT_16: Sprite (16 x 16). 

WEE Single-color tile (free size). 

TILE1: DOL xT): 

TILES: Single-color tile (8 x 8). 

TILE16: Single-color tile (16 x 16). 

Block Fill: Block fill. 


Read/Write Penalty 
The read/write penalty analysis displays duplicate read accesses. 
A duplicate read is recognized when the valid range (256 cycles by default) is read despite no write operation having 


been performed since It was read last. The number of cycles in this range and the range of the target data area can 
be set using the Option dialog box (the default data area is all of main RAM). 


A typical cause of duplicate read is when data which is not assigned to a register is assigned to a stack and read 
several times. But, duplicate read is also recognized when the same address has been read continuously for 
polling. The area of each item corresponds to the CPU stall cycle time due to duplicate read. 


None: Normal status. 
Duplicate Read: Duplicate data read cycles. 


Write Buffer Penalty 


The write buffer penalty analysis displays the stall cycles caused by buffer flush at the instant a write cycle 
completes. This analysis enables the detection of those read/write patterns which adversely affect the write buffer 
efficiency. The area of each item corresponds to the CPU stall cycle time caused by write buffer flush. 
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Note: The areas indicated for write buffer penalty analysis do not always mean that the CPU has stalled for the 
corresponding period. For details, refer to the Performance Analyzer Technical Reference. 


None: Normal status. 
Flush Penalty: Write buffer flush penalty. 


Polygon Penalty 


Polygon penalty analysis calculates and displays the wasted cycles by evaluating the pre-processing time and 
redundant drawing time for each of the polygons which protruded from the frame, which have an area of O, or 
which have not been subjected to normal clipping. The default screen size and offset value for clipping are 320 x 
240 and (0, 0). When the program uses different values, the new screen size and offset value should be specified in 
the Option dialog box. 


Note: Those penalties are estimated values and they are not accurate. Please use them as references. 


None: Normal status. 

Outside Frame: Polygon which is entirely outside the frame (pre-processing time + drawing 
time). 

Scissoring: Polygon which protrudes outside the left or top edge of the frame (redundant 
drawing time). 

Back Face: Back-face polygon (pre-processing time + drawing time). 

Zero Area: Polygon with an area of O (pre-processing time only). 


Waveform Display 


OYSCLK: system clock. 

VBLNK: V blank signal. 

GUNINT*: Interrupt request from Gun. 
RXD1*: Link cable signal. 

DSR1*: Link cable signal. 

CTs": Link cable signal. 


Note: "*" indicates a negative logic signal. 


Access Display 


The following four access displays are shown in the status existing immediately before reading the map file. 
The colors of the access displays correspond to those of the labels for the main RAM bus status. 
<Segment accesses> 


stack_seg: Access to a stack segment. 
(The segment is displayed when the map file has been read.) 
unknown location: Access to a segment other than a stack. 


<Global symbol accesses> 


_STACK_: Access to a stack. 
(The global symbol is displayed when the map file has been read.) 
unknown location: Access to a global symbol other than a stack. 


Note: When the stack range is not set properly, the global symbol having the highest address may sometimes be 
mistakenly identified and displayed as the stack address. 


Performance Analyzer User Guide 


Details 4-11 


Option Setup 


This section describes the dialog box used for setting the display and changing the measurement range, etc. 


Option dialog box 


From “Setting” menu, select "Options..." to open the Option dialog box. This dialog box is used to change or save 
the display-related parameters, measurement range, etc. Clicking the OK button after changing the parameters 
applies them to the current file. Clicking the “Save” button applies the changed parameters to new files that are 
next created. 


Figure 4-2: Option Dialog Box 
Options 
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Graph Display (on/off) Switch the nine graph display on-off. 
(see Section 2.2.1 Switching the displayed graphs) 
Data Acquisition Range: Set the range in which data is to be measured and read. 


This setting is applied from the next measurement. 
(see Section 3.2 Setting the Measurement Range) 


Video Mode Select NTSC or PAL. 

Analysis Pixel Width: Set the pixel width of the analysis showing the main RAM 
bus status. 
(see Section 2.2.4 Changing the analysis display and 
pixel width) 


Performance Analyzer User Guide 


4-12 Details 


Display Level of Waveform: 


Display Level of Access: 


Stack Range of a tested program: 


Target Range of Read/Write Penalty: 


The Number of effective clock cycles: 


Program’s Screen Size: 


Offset for drawing: 


Reverse the order of vertices (Back Face): 
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Specify the view size with which the waveform display 
should begin. 

(see Section 2.2.5 Changing the display levels of the 
waveform display and access display) 

Specify the view size with which the access display 
should begin. 

(see Section 2.2.5 Changing the display levels of the 
waveform display and access display) 

Set the stack range of the program to be measured. 
(see Section 2.2.7 Setting the stack range) 

set the main RAM area which becomes the target of 
read/write penalty. 

(see Section 4.2.6 Read/Write Penalty) 

Set the number of effective clock cycles for read/write 
penalty. 

(see Section 4.2.6 Read/Write Penalty) 

Set screen size for polygon penalty. 

(see Section 4.2.8 Polygon Penalty) 

Set offset for polygon penalty. 

(see Section 4.2.8 Polygon Penalty) 

Check the box if you reverse the order of vertices for 
polygon penalty. 

(see Section 4.2.8 Polygon Penalty) 


